package com.tianji.aigc.service;

import com.tianji.aigc.domain.po.ChatSession;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.aigc.domain.vo.ChatSessionVO;
import com.tianji.aigc.domain.vo.MessageVO;
import com.tianji.aigc.domain.vo.SessionVO;

import java.util.List;
import java.util.Map;

/**
 * <p>
 * 对话session 服务类
 * </p>
 *
 * @author lzy
 * @since 2025-10-13
 */
public interface IChatSessionService extends IService<ChatSession> {

    /**
     * 创建会话session
     *
     * @param num 热门问题的数量
     * @return 会话信息
     */
    SessionVO createSession(Integer num);

    /**
     * 获取热门问题
     * @param num 热门问题的数量
     * @return 热门问题
     */
    List<SessionVO.Example> getHotQuestions(Integer num);

    /**
     * 根据会话id查询消息列表
     *
     * @param sessionId 会话id
     * @return 消息列表
     */
    List<MessageVO> queryBySessionId(String sessionId);

    /**
     * 更新会话更新时间
     *
     * @param sessionId 会话ID，用于标识特定的聊天会话
     * @param title     新的会话标题，如果为空则不进行更新
     * @param userId    用户ID
     */
    void update(String sessionId, String title, Long userId);

    /**
     * 查询历史会话
     * @return 历史会话
     */
    Map<String, List<ChatSessionVO>> queryHistory();

    /**
     * 删除历史会话
     * @param sessionId 会话id
     */
    void removeHistory(String sessionId);

    /**
     * 更新历史会话
     * @param sessionId 会话id
     * @param title 新的会话标题
     */
    void updateHistory(String sessionId, String title);
}
